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COMPUTER GRAPHICS COLOR MANAGEMENT SYSTEM 

BACKGROUND OF THE INVENTION 

Field of the Invention 

The present invention relates to color computer graphics, more 
5 particularly to color management systems, i.e., systems (typically software) that 
provide for the exchange and use of color information in a computer 
environment in which different devices have different color characteristics. 

State of the Art 

10 As color devices for input and output proliferate, so do the problems of 

moving images between them with good results. Differing device types operate 
in different color spaces. Within those spaces, the colors the devices can 
actually produce constitute differing gamuts, or ranges of colors. Monitors, for 
example, typical display colors as combinations of red, green, and blue, and are 

15 said to work in the RGB color space. Monitors by different manufacturers may 
be capable of displaying different intensities of those three colors, so that even 
though they work in RGB space, their gamuts may be different. Printers 
typically work with varying intensities of cyan, magenta, yellow, and black, and 
are said to work in the CMYK color space. Print technologies vary drastically, 

20 and the gamut that an ink jet color printer can display may be quite different 

from one based on another technology. A single printer may be able to produce 
different gamuts depending on the paper or ink being used at the time of 
printing. Devices with differing color gamuts cannot reproduce each other* s 
colors exactly but shifting the colors of one by a carefully chosen profile may 

25 improve the visual match between them. 

The most obvious difference for many users is between an image as it 
appears on the monitor and as printed by a color printer. Monitor colors are 
additive-adding color moves the image toward white--and are generally more 
vivid. Printed colors are subtractive-adding colors moves the image toward 

30 black or dark gray. Under most viewing conditions, the white of a monitor will 



WO 95/3 1794 J 'J PCT7US95/06237 



■1 



appear bluish when compared to a sheet of paper, even though the eye perceives 
both as white when viewed separately. 

A color management system is a system that supports color information 
exchange, color matching, color profile management, and device calibration. 
5 Color management offers the means of transmitting color images and documents 
containing color across local and wide area networks while maintaining the 
fidelity of the colors of the original image or document. 

In January 1993, Apple Computer introduced a color management 
system, ColorSync™ 1.0, in the form of a suite of utilities. The ColorSync 

10 Utilities define a process (the color matching method, or CMM) for matching 
colors between gamuts, and a data structure (the color profile) for holding 
information about the characteristics of a particular gamut. The ColorSync 
Utilities provide a default CMM and a default system color profile for Apple 
monitors. Because the ColorSync Utilities are designed to provide an "open 

15 system" for color management, developers can use an Apple-supplied default 
CMM and color profile, create their own, or obtain them from vendors, and use 
them with the ColorSync Utilities. 

The ColorSync Utilities provide applications with several tools for 
matching colors between devices. These include: a default system color profile 

20 that describes the gamut of the Apple RGB 13 inch monitor, a control panel 
(cdev) interface by which users can set their system profile, a means of 
specifying and obtaining color profiles for other devices, a means of tagging 
pictures with color profiles, a default color matching method, a folder for 
storing color profiles, an open architecture that allows developers to create or 

25 obtain a custom color matching method and associate it with a device profile, 
and the ability to report matching progress to the user. 

The ColorSync Utilities contain high level routines that can query and set 
a color profile, begin and terminate matched drawing, match a picture's colors 
as it is drawn, tag a picture with one or more color profiles, and test whether 

30 colors are in a device's gamut. The ColorSync Utilities also contain low-level 
routines for matching specific lists of colors, matching pixel map colors, 
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monitoring the progress of color matching, and creating a custom color 
matching method. 

Color matching means converting colors between differing color gamuts. 
A color matching method (CMM) implements an algorithm that determines how 

5 to convert the colors. In general, whereas device drivers supply CMMs 

appropriate to their device (since the driver knows the color characteristics of 
the device), applications typically do not need to create CMMs. With 
ColorSync™, device drivers can create their own CMMs, obtain them from 
other vendors, or use the CMM provided as the default by Apple. 

10 Because enumerating all the colors in a gamut is generally impractical, 

the ColorSync Utilities describe a color gamut by a set of characteristics (the 
color profile) that define key parameters, such as the points of purest white and 
black, tonal response curves for primary colors, and the type of CMM for which 
the profile was intended. 

15 Each CMM may offer matching options, so that the user can tailor the 

match depending on the kind of image being processed. Typically, color 
matching alters the colors of an image being transferred from one device to 
another such that the resulting image looks as close to the original as possible. 
A number of methods may be used to alter the colors. 

20 Given two overlapping but non-coincident color gamuts A and B, for 

example, in some circumstances it may be best to only alter the colors of space 
A that do not exist in space B The advantage is that many colors are exactly 
the same in both images, which may be required when using Pantone™ colors 
to prepare a book for printing, for example. The disadvantage is that the best 

25 mapping of the colors that must change may be the same as existing colors, 

reducing the actual number of colors in the copy. Maintaining the same colors 
wherever possible is called a colorimetric match. 

With realistic, photographic images it may be better to alter all the colors 
of the first space, to move them so that their relative positions are the same 

30 when relocated to the second space. The advantage is that a greater number of 
colors may be preserved, and the relationship between colors is maintained. The 
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disadvantage is that none of the original colors is the same in the copy. Since 
the colors in this case will appear the same to the eye, even though they may 
vary drastically if measured by instrument, this is called a perceptual match. 

A third possibility is to maintain saturation: computer-generated bar 
5 charts, for example, do not require exact matching of the particular hues used: it 
may be more important that the image is vivid so it will project well. 

Applications can set one of three corresponding matching options in a 
source profile header to choose variations on the techniques used for color 
matching. A perceptual match uses the destination white point, maintains 
10 lightness, and is good for real-world images. A colorimetric match uses the 

source white point and is good for spot-color matches. A saturation match uses 
the destination white point, maintains saturation for out-of-gamut colors, and is 
good for charts. 



15 exist on the same page. For example, a page might contain a photograph that 
was scanned, some bar charts that were generated with a statistical package, and 
some line art that was generated using spot colors, as shown in Figure 1. 

When the page is captured as a picture, the data stream will represent 
different matching operations required for proper rendering, as follows: 



// For the photograph // 
PicComment( CMBeginProfile) 

{Contains pr2, a profile which has a device type of *scnr,' and options 
that indicate perceptual match } 



ColorSync allows multiple data types that have different matching to 



20 



25 



Here matching occurs using the perceptual match option. 
PicComment (CMEndProfile) 



Here any matching occurs using the system and device profiles. 



30 



//For spot color line art// 
PicComment (CMBeginProfile) 

{Contains prl, a profile which has device type 'mntr' and options that 
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indicate colorimetric match} 

Since no CMEndProfile picture comment was encountered, matching 
continues using this profile. 

5 

PicComment (CMDisableMatching) 

Here there is no matching and data is passed straight through. 
PicComment (CMEnableMatching) 

Now things are matched using the 'mntf profile with colorimetric 
10 matching again. 

//For bar chart// 

PicComment (CMBeginProfile) 

(Contains a profile which has device type 'mntr' and options that 
15 indicates saturation} 

Here matching occurs using the saturation match option. 
PicComment (CMEndProfile) 

Here any matching occurs using the system and device profiles again. 
20 An application or driver sets the options to the values it needs before 

calling ColorSync Utilities* matching functions, or before tagging a picture with 
a color profile (i.e., embedding the color profile in the picture). 

All CMMs are components that a Component Manager of the Macintosh 
system software calls in response to calls of applications or drivers through a 
25 defined application interface (API). A component is a piece of code that 

provides a defined set of services to one or more clients. Applications, system 
extensions, as well as other components can use the services of a component. A 
component typically provides a specific type of service to its clients. For 
example, a component might provide image compression or image 
30 decompression capabilities; an application could call such a component, 

providing the image to compress, and the component could perform the desired 
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operation and return the compressed image to the application. In the case of 
ColorSync, the type of service performed is color matching. An application or 
device driver can call ColorSync, providing an image, a source color profile and 
a destination color profile, and ColorSync will call the appropriate CMM 
5 component to perform color matching or other color management functions and 
return the result (e.g., a color-matched image) to the application or device 
driver. 

Multiple components can provide the same type of service. For example, 
separate components might exist that can compress an image by 20 percent, 40 

10 percent, or 50 percent, with varying degrees of fidelity. Similarly, different 
CMMs may achieve varying degrees of color fidelity. All components of the 
same type must support the same basic interface. This requirement allows an 
application or driver to use the same interface for any given type of component 
and get the same type of service, yet allows applications and drivers to obtain 

15 different levels of service. 

The Component Manager provides access to components and manages 
them by, for example, keeping track of the currently available components and 
routing requests to the appropriate component. The Component Manager 
classifies components by three main criteria: the type of service provided, the 

20 level of service provided, and the component manufacturer. The Component 
Manager uses a component type, consisting of a sequence of four characters, to 
identify the type of service provided by a component. CMMs have a 
component type of CMM ' . In addition, CMMs have a signature. The 
signature of the default CMM is appl ' . Third party CMMs are registered 

25 with Apple and assigned a CMM signature. 

The Component Manager provides services that allow applications to 
obtain run-time location of and access to functional objects by creating an 
interface between components and clients. Instead of implementing support for 
a particular data format, protocol, or model of a device, a standard interface is 

30 used through which an application can communicate with all components of a 
given type, such as CMMs. The Component Manager may be used to locate 
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and communicate with components of that type. Those components, in turn, 
provide the appropriate services to the client application. 

Given a particular component type, the Component Manager can locate 
and query all components of that type. An application can find out how many 
5 components of a specific type are available and can get further detail about a 
component's capabilities without having to open it first. For each component, 
the Component Manager keeps track of many characteristics, including its name, 
icon, and information string, which may contain any arbitrary information about 
the component. 

10 Components of the type *CMM' provide color matching services. All 

components of type ' CMM ' share a common application interface, but each 
component may support a unique color matching technique or take advantage of 
a special hardware implementation. Individual components may support 
additions to the defined application interface, as long as they support the 

15 common routines any algorithm-dependent or implementation-dependent 
variations of the general interface can be implemented by each ' CMM ' 
component as extensions to the basic interface. 

The Component Manager allows a single component to service multiple 
client applications at the same time. Each client application has a unique access 

20 path to the component. These access paths are called component connections. 
A component connection is identified by specifying a component instance. The 
Component Manager provides this component instance to an application when it 
opens a connection to a component. This component maintains separate status 
information for each open connection. 

25 Multiple applications might each open a connection to a color matching 

component. The Component Manager routes each application request to the 
component instance for that connection. Because a component can maintain 
separate storage for each connection, application requests do not interfere with 
each other and each application has full access to the services provided by the 

30 component. Further information concerning component-based design may be 
found in Inside Macintosh, More Macintosh Toolbox. 
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In accordance with the foregoing component-based design, the ColorSync 
Utilities provide a default CMM: developers of device drivers can create or buy 
other CMMs, tailored to the requirements of their devices. 

Referring more particularly to Figure 2, the shaded blocks represent the 
5 color management system, which includes a component based color management 
framework interface, a default CMM, and Apple supplied profiles including a 
default system profile and additional profiles of Apple peripherals. The color 
management system is interoperable with third party CMMs and with third party 
device profiles, which the color management system may use to perform color 

10 matching. The color management system may be called upon by applications 
directly (through a predefined application program interface, or API) to perform 
color matching, or the application may call upon a graphics library or an 
imaging library to perform color-matched services, in which case the graphics 
library or the imaging library will then call upon the color management system 

1 5 to perform color matching. 

To perfonrn color matching, the ColorSync Utilities use the Component 
Manager to call a color matching method. The actual matching happens inside 
the color matching method component. Figure 3 shows the relationship 
between an application, the ColorSync Utilities, and the color matching 

20 component. 

Device drivers generally provide their own color profiles, and perform 
the match by calling the ColorSync Utilities. This ensures that as new devices 
become available, existing applications continue to receive matched input and 
produce matched output. Applications can print with confidence that the device 
25 driver will produce the best color translation. 

Applications can use color matching to create a print preview dialog, 
showing which colors in the printed image are out of the image gamut as it 
appears on the monitor, for example. Applications that generate images can 
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automatically tag the image with the appropriate profile, or allow the user 
to tag it. 

Color matching always matches the colors of a source profile to the 
colors of a destination profile using a color matching method. The matching 
5 process takes one or more steps, depending on whether the source and 
destination profiles are the same type, and therefore use the same CMM. 

If the source and destination profiles can use the same color matching 
method, the colors are mapped directly from one color gamut to the other. 

If they use different methods, colors are mapped from the source profile 
10 to a profile describing XYZ space, a standard intermediate space, using the 
matching method associated with the source profile. Colors are then mapped 
from XYZ space to the destination profile, using the matching method 
associated with the destination profile. If either the source or the destination 
profile parameter to a matching routine is NIL, the ColorSync Utilities use the 
15 default system profile in its place. 

Figure 4 diagrams the default condition, in which input devices match to 
the system color profile, and output devices match from it to the profile of their 
device. 

In the input matching step, colors are mapped from the device's profile 
20 to the RGB space of the system color profile. In the output matching step, the 
colors are mapped from the system RGB space to the color space of the output 
device. 

Thus, in this default matching case, input drivers match to the system 
profile, and output drivers match from the system profile. Applications work 
25 without modification since the drivers do the matching. 

Profiles reside in files (usually in a ColorSync™ Profiles folder), with 
device drivers, or in pictures. All ColorSync™ 1 .0 profiles have a header, a 
copy of an Apple CMProfileChromaticities record (containing colorant values), 
profile response data for the associated device, and a profile name string for use 
30 in dialog boxes. Custom profiles may also have additional, private data. The 
profile record is diagrammed in Figure 5. 
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The device type field indicates the type of device for which the profile is 
intended. Three standard types arc: 

PrinterProfile 'par' 

ScannerProfiie 'scnr T 
5 MonitorProfile 'mntr' 

The response data fields contain nine curve tables defining device 
gamma values. Seven tables are always filled in; the last two are used only for 
printers using four colors (CMYK). The first table is for grayscale values. The 
next three are red, green, and blue values, followed by three for cyan, magenta, 
10 and yellow values. Each table includes a count field. The count value specifies 
the number of entries in the curve table except as follows: 

when count is 0, then a linear response (slope equal to 1.0) is assumed, 

when count is I, then the data entry is interpreted as a simple gamma 
value (ranging from 0 to 8), and 
15 when count is 3, the entries are interpreted as a gamma-offset-gain 

model. 

The eighth and ninth tables are for CMYK printers and specify 
undercolor removal and black generation data, respectively. Placing a 0 in the 
counts field specifies maximum undercolor removal and maximum black 
20 generation. 

The name string of the profile is used by the user interface. Applications 
cart retrieve ColorSync 1.0 profiles using a GetProfile function. Calibration 
programs can attach a profile to a device using a SetProfile function. Profiles 
can be obtained from currently attached devices that support ColorSync and 

25 from the ColorSync™ Profiles folder, if present. Profiles can be created by 
hand, or by using a utility such as ProfileMaker. 

The ColorSync Utilities provide an open architecture that can work with 
a variety of color matching methods and color profiles. ColorSync determines 
which CMM to use, based on the CMMType field of the source and destination 

30 profiles used in a match. (If either profile is missing or NIL, ColorSync uses 
the system profile.) 
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Since any particular configuration may include a variety of input and 
output devices, each with its own CMM and, profiles, the ColorSync Utilities 
follow a defined sequence to determine which CMM to use in a given match. 
In the sequence, the default CMM is last in the list, to be used if no other CMM 
5 is specified, or a specified CMM is not available. The process of choosing a 
CMM to perform a match is referred to as CMM arbitration. 

ColorSync™ 1.0 chooses which CMM to use for a match according to 
this sequence: 

1. If both the source and destination profiles have the same CMMType 
10 and the corresponding CMM component is available then matching is performed 

entirely by that CMM, as shown in Figure 6, where RGB input data is matched 
to CMYK output data. (If the CMM is not available, ColorSync uses the 
default CMM.) 

If the profiles have different CMMType values then ColorSync attempts 
15 the following alternatives in order. 

2. If the CMM for the destination profile is available (and is not 
Apple's) then it is called with the two profiles. If the CMM can match using 
that source profile it returns noErr and matching is performed entirely by the 
CMM corresponding to the destination profile. If a profile error is returned then 

20 alternative 3 is tested. 

The Apple-supplied default CMM will always respond noErr and try to 
perform a match. All profiles must contain the elements necessary for the 
default CMM. If either the source or destination profile has a CMMType value 
other than 'appl/ that CMM will get a chance to perform the match. The 

25 default CMM is always the last to be chosen, and it always attempts the match 
if asked. 

3. If the CMM for the source profile is available (and it is not the 
default CMM) then it is called with the two profiles. If it can perform the 
match then matching is performed entirely by the CMM named by the source 

30 profile. 
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If the CMM returns an error then the CoIorSync Utilities try 
alternative 4. 

4. If the CMMs for both the source profile and destination profile are 
available-but neither can perform the match, as determined by steps 2 and 3- 

5 CoIorSync converts the source data from RGB space to XYZ space using the 
source profile and its corresponding CMM. Then CoIorSync converts the XYZ 
color space to the destination RGB space using the destination profile and its 
CMM, as shown in Figure 7. 

If this is not possible (one of the CMMs is missing) then alternative 5 is 
10 the fallback. 

5. If one or both of the CMM components corresponding to a profile is 
not available then CoIorSync uses the default CMM for that step of the match, 
using the Apple format data required in all CoIorSync profiles. 

A CMM must support RGB and CMYK as input color spaces, and RGB, 
15 XYZ, and CMYK as output color spaces. 

In the foregoing CMM arbitration method, the potential exists for some 
CMMs to be unfairly shut out. Since the destination CMM is queried first and 
given first opportunity to perform the color match, the situation may arise in 
which a destination CMM may aggressively respond affirmatively to all queries, 
20 even if it is not the best CMM for the job. 

Furthermore, in CoIorSync™ 1 .0, no API support is provided for 
PostScript® conversion. PostScript has established itself as the page description 
LANGUAGE of choice among graphics and pre-press user communities. It is 
also becoming one of the standard imaging models supported on all major 
25 platforms. Integrating color management system functions to support PostScript 
is therefore highly desirable. 

Most high-end printers and image setters have PostScript controllers and 
do not understand any command other than PostScript. To control the color 
output from these devices, PostScript Level 2 defined a device-independent 

30 color mechanism to specify and render color. To integrate color device profiles 

f 

used by color management systems with PostScript devices, conversions have to 
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be done between color profiles and PostScript. 

The main function of a PostScript driver is to convert from the platform 
native graphic format to PostScript for printing. One example of a PostScript 
driver is the PSWriter 8,1. It converts Quickdraw format on the Macintosh to 
5 Postscript. In the CoIorSync 1.0 system, when a color profile is embedded in 
the document, the driver will convert it into Postscript also. If no profile is 
embedded with the document, the CoIorSync System Profile is used. 

The CoIorSync 1.0 profile format is extendible, as are some other color 
profile formats. Many profile vendors therefore put custom information in the 
10 private fields of such formats. The custom data provides higher performance 
when used with the preferred CMM. However, the driver does not understand 
how to interpret the custom data and may not have access to the preferred 
CMM. As a result, the quality of the output from the Postscript devices is less 
than optimal. 

15 CoIorSync™ 1.0 makes no provision for profile validation to determine 

whether or not % profile contains all of the required fields. Using profiles that 
do not contain all of the required fields may have a range of effects from mild 
(improper matching) to severe (causing a system crash). 

CoIorSync™ 1 .0 provides only limited support for concatenation profiles 

20 in which a transformation is calculated from a sequence of profiles (for a print 
preview operation, for example, from monitor device space to printer device 
space and back to monitor device space). In CoIorSync™ 1.0, concatenation 
profiles cannot be saved for future use or embedded in images. 

Moreover, in CoIorSync™ 1.0, the profile format is memory resident. 

25 Such a profile format does not readily lend itself to extension and improvements 
without creating a memory burden on the host system. 

SUMMARY OF THE INVENTION 
The present invention, generally speaking, provides in an 
operating-system-level color management system a scalable, flexible and 
30 extensible solution to managing color in color computer graphics systems. A 
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disk-based, tagged-element structure allows selective access to profile data. The 
color management system dynamically arbitrates and dispatches to color 
matching modules (CMMs) and other code modules to perform color 
management functions such as color matching, color space conversion, profile 
5 management, profile file and element access, profile validation, and converting 
profiles to PostScript. A CMM arbitration method ensures fairness for both 
source and destination profiles. 

BRIEF DESCRIPTION OF THE DRAWING 
The present invention may be further understood from the following 
10 description in conjunction with the appended drawing. In the drawing: 

Figure 1 shows an example of a page containing a scanned photograph, a 
bar chart generated with a statistical package, and line art generated using spot 
colors; 

Figure 2 is a block diagram showing the architecture of a known color 
15 management sysfem; 

Figure 3 shows the relationship between an application, the ColorSync 
Utilities, and the color matching component in the color management system of 
Figure 2; 

Figure 4 diagrams a default matching condition in the color management 
20 system of Figure 2, in which input devices match to the system color profile, 
and output devices match from it to the profile of their device; 

Figure 5 is a diagram of a ColorSync™ 1.0 profile record; 

Figure 6 illustrates a case in which, in the color management system of 
Figure 2, matching is performed entirely by a single CMM where both the 
25 source and destination profiles have the same CMMType and the corresponding 
CMM component is available; 

Figure 7 illustrates the case in which, in the color management system of 
Figure 2, ColorSync first converts the source data from the source space to XYZ 
space using the source profile and its corresponding CMM and then converts the 
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XYZ color space to the destination space using the destination profile and its 
CMM; 

Figure 8 is a functional block diagram of the color management system 
of the present invention; and 
5 Figure 9 is a diagram of a color profile format in accordance with the 

present invention. 

DETAILED DESCRIPTION OF THE PREFERRED EMBODIMENTS 
Referring to Figure 8, the present color management system architecture 
is divided into five parts: 1) a memory-resident dispatcher, 2) profile 

10 management functions, 3) color space conversion functions, 4) color 

management methods (CMMs), and 5) a standard cross-platform color profile 
format. The memory-resident dispatcher, profile management functions, color 
space conversion functions,color management methods and color profiles are 
identified in Figure 8 by reference numerals 10, 22, 30, 40 and 50, respectively. 

15 The profile management, color space conversion, and color management 

functions are all implemented using the Component Manager 60. Components 
are dynamically dispatched on demand. In addition, the Component Manager 
provides database facilities to track each component in the system, allowing the 
resident dispatcher 10 to call the appropriate component. 

20 The resident dispatcher provides the overall color management 

administrative framework and manages the interaction between the application, 
the various color management pieces, and the actual color image. Typically, the 
dispatcher receives input from the application, analyzes the current profiles and 
passes the image and profile data to the appropriate CMMs to perform the 

25 actual color transformation. Each profile contains information on the preferred 
CMM for that particular profile. An arbitration scheme within the dispatcher 
determines which CMM has precedence in the transformation process. In 
addition to this primary function, the dispatcher calls the appropriate color 
conversion methods when there exists a mismatch between profile interchange 

30 spaces. 
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On the Macintosh computer system, the color management system 
consists of an Extension file from which the resident dispatcher is installed at 
system startup. A separate Control Panel file provides user control of the 
ColorSync System Profile. The color management system relies on the 
5 Component Manager for the basis of the framework which allows plug-and-play 
capability for third party color-matching implementations. 

On 680X0 Macintoshes, the dispatcher is implemented using the Toolbox 
A-trap mechanism. The interface defines the value for register DO at the time a 
function is called. A selector is in the low 16 bits and the parameter size is in 
10 the high 16 bits. The functions use pascal stack-based calling conventions. The 
color management system implements a 680X0 mainline function which 
internally dispatches individual calls on the selector. 

On other computer systems, the specific implementation of the dispatcher 
will vary. 

15 Device profiles provide color management systems necessary information 

to convert color data between native device color spaces and device independent 
color spaces. In the present color management system, color devices are divided 
into three broad classifications: input devices, display devices and output 
devices. For each device class, a series of base algorithmic models are 

20 described which performs the transformation between color spaces. These 

models provide a range of color quality and performance results. Each of the 
base models provides different trade-offs in memory footprint, performance and 
image quality. The necessary parameter data to implement these models is 
contained in the required portions of the appropriate device profile descriptions. 

25 This required data provides the necessary information for the color management 
framework default color management module (CMM) to transform color 
information between native device color spaces. 

Selecting an appropriate color matching module to perform a color 
matching operation is referred to as CMM arbitration. As compared to 

30 ColorSync 1 .0, the present color management system uses a more efficient 
arbitration scheme, as follows: 
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I. If both the source and destination - profiles have the same CMMType 
and the corresponding CMM component is available then matching is performed 
entirely by that CMM. If the CMM is not available, the color management 
system uses the default CMM. 
5 2. If either source or destination CMM is not available, that CMM is 

replaced with the default CMM. If both the source and the destination CMMs 
are not available, the color management system uses the default CMM and the 
matching is performed entirely by the default CMM. 

3. A concatenated transformation table is built by either the dispatcher 
10 of the default CMM sampling the source data space and converting the sampled 

color points into destination data space using source and destination CMMs. 
This is done by first converting the source data to the interchange space data 
using the source CMM, then converting between interchange spaces from source 
profile to destination profiles, if different, using the color space conversion 
15 functions, and finally converting from the interchange data space to the 
destination data space using the destination CMM. 

4. Colors are converted from source to destination data spaces by doing 
a table look up using the transformation table built in Step 3. 

This improved scheme provides the most flexible CMM arbitration by 
20 giving the preferred CMM first chance to convert between device space and 

interchange space, while improving the performance by building a concatenated 
transformation table. This arbitration scheme also avoids the possible 
domination of destination CMMs by always answering yes when queried 
concerning the ability to perform a matching operation. 
25 Referring to Figure 9, the profile structure, rather than being 

memory-resident, is defined as a series of tagged elements that can be accessed 
randomly and individually. The collection of tagged elements provides three 
levels of information: required data, optional data and private data. A tag data 
header provides a table of contents for the tagging information in each 
30 individual profile. The header includes a tag signature and the beginning 
address offset and size of the tag for each individual tagged element. This 
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tagging scheme allows the tag data header to be read in. after which the 
information necessary for a current software application may be randomly 
accessed and loaded into memory. Since some instances of profiles can be quite 
large, this arrangement provides significant savings in performance and memory. 
5 The required tags provide the complete set of information necessary for 

the default CMM to translate color information between the color interchange 
space and the native device space. A default modeling method for each device 
class determines which combination of tags is required. For example, a multi- 
dimensional lookup table is required for output devices, but not for display 
10 devices. 

A number of optional tags are defined that can be used for enhanced 
color transformations, including tags that support PostScript Level 2 and 
calibration, among others. 

Private data tags allow CMM developers to add proprietary value to their 
15 profiles. Private data tags allows developers to maintain proprietary advantages 
without sacrificing compatibility. 

Referring still to Figure 9, the header provides a set of parameters at the 
beginning of the profile format. In a preferred embodiment, the header is 
fixed-length (128 bytes) and contains the following information: 
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byte(s) 


content 


0-3 . 


Profile size. 


4-7 


Identifies the preferred CMM to be used. 


8-11 


Profile version number. 


12-15 


Profile/Device class. 


16-19 


Color space of data (possibly a derived space) [i.e., 
"the canonical input space"]. 


20-23 


Interchange color space [i.e., "the canonical output 
space"]. 


24-35 


Date and time this profile was first created. 


36-39 


'acsp' (0x61637370) profile file signature 


40-43 


Primary platform target for the profile. 


44-47 


Flags to indicate various options for the CMM such 
as distributed processing and caching options. 


48-51 


Device manufacturer of the device for which this 
pronic is created. 


52-55 


Device model of the device for which this profile is 
created. 


56-63 


Device attributes unique to the particular device setup 
such ds ineuid lype. 


64-67 


Specifies the rendering intent of this profile for the 
CMM. Photographic, spot colors and business 
graphics are the three intents required to be supported 
with default values of 0, l and 2 respectively. 


68-79 


The relative XYZ values of the white point of the 
color space. 


80-91 


The relative XYZ values of the black point of the 
color space. 


92-127 


36 bytes reserved for future expansion. 



In a preferred embodiment, the profile format supports a variety of both 
20 device-dependent and device independent color spaces divided into three basic 

families: l) CIEXYZ based, 2) RGB based, and 3) CMY based. A subset of the 



BNSDOCID: <WO 9531794A1 J_> 



WO 95/31794 



PCT/US95/06237 



- 20 - 

CIEXYZ based spaces are also defined as exchange spaces. Other device 
dependent color spaces may be also used. Any of the defined color spaces may 
be used as a device space, which corresponds to the source or destination color 
space in a color modeling session. 
5 A key component of a color profile is the choice of color interchange 

spaces. These spaces provide the "universal language" with which any number 
of color devices can communicate color information with each other. Most 
color interchange spaces today are based on the CIE 1931 standard observer. 
This experimentally derived standard observer provides a very good 

10 representation of the human visual system's color matching capabilities. Two 
color spaces based on these results have become very popular in color 
management systems: the 1931 CIEXYZ space and the 1976 CIELAB space. 
The CIEXYZ space represents a linear transformation of the derived matching 
responses and the CIELAB space represents a transformation of the CIEXYZ 

15 space into one that is nearly perceptually uniform. This uniformness allows 
color errors to b$ equally weighted throughout its domain. 

Three color interchange space encodings are supported in the preferred 
embodiment 16 bit per component CIEXYZ, 16 bit per component CIELAB and 
8 bit per component CIELAB. While supporting multiple interchange spaces 

20 increases the complexity of color management, it provides immense flexibility in 
addressing different user requirements such as color accuracy and memory 
footprint. 

The device profiles along with the appropriate device models provide a 
translation mechanism between the native device color space and one of these 
25 three color interchange space encodings. 

The choice of device space and color interchange space is indicated 
within the profile itself as follows: 
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Color Space 


Signature 


XYZData 


XYZ" 


iabData (16 bit per 
component) 


'Lab' 


Iab8Data (8 bit per 
component) 


'Lab8' 


luvData 


'Luv' 


YxyData 


'Yxy' 


rgbData 


RGB* 


grayData 


'GRAY' 


hsvData 


•HSV 


hlsData 


*HLS' 


cmykData 


'CMYK' 


c my Data 


CMY' 



10 



15 



20 



25 



30 



Requiring tags with profiles is a way to provide a common base level of 
functionality. If a custom CMM is not present, then the default CMM will have 
enough information to adequately model the data. The required data for 
different devices and the particular models implied by the required data are set 
forth in Appendix 1 below. While the required data might not provide the 
highest level of quality obtainable with optional data and private data, the data 
provided is adequate for sophisticated device modeling. 

Profiles need to be validated to contain required color information for the 
tagged CMM to use. A ValidateProf ile function is provided to test 
whether a specified profile contains the minimum set of elements. This function 
is dispatched to the CMM specified by the Profile CMMTypeTag element. 
If the CMM is not available then the default Apple CMM is called. Only the 
existence of Profile elements is checked. The element content and size are 
not. 

The dispatcher, upon receiving a request to validate a profile, will do the 
following steps. 



BNSDOCIO: <WO 9531794A1_L> 



WO 95/31794 



J PCT/US95/06237 



- 22 - 

1. Get the name of the preferred CMM from the profile. 

2. If available, dispatch the preferred CMM to do the validation. 

3. If not available, dispatch the default CMM to do the validation. 
Whether or not a tag is required depends on the profile type. Tags that 

5 are required in some profile types may be optional in other profile type. In 
addition, optional tags not generally required in a profile type include the 
following: 



10 



15 



20 



Tap Name 


vjcncrui L^escnpuon 


calibrationDateTimeTag 


Profile calibration date and time 


gcrTag 


Gray component replacement curve 


ucrTag 


Under color removal curve 


charTargetTag 


Characterization target such as IT8/7.2 


luminanceTag 


Absolute luminance for emissive device 


measurementTag 


Alternative measurement specification 
such as a D65 illuminant instead of the 
default D50 


viewingConditionsTag 


Specifies viewing condition parameters 


namedColorTag 


Named color dictionary for converting 
between named color sets and 
interchange spaces 


previewOTag 


Preview transformation: 8 or 16 bit 
data: intent value of 0 


preview 1 Tag 


Preview transformation: 8 or 16 bit 
data: intent value of I 


preview2Tag 


Preview transformation: 8 or 16 bit 
data: intent value of 2 


monitoringTag 


monitoring attributes such as frequency, 
angle and spot 


deviceMfgDescTag 


displayable description of device 
manufacturer 


deviceModelDescTag 


displayable description of device model 
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technologyTag 


Device technology information such as 
LCD, CRT, Dye Sublimation, etc. 


srcDeviceAttributesTag 


Device attributes for source profile 


srcDeviceModelTag 


Device model designation for source 
profile 


srcManufacturerTag 


Device manufacturer for source profile 


srcDeviceMTpDescTa** 


Disnlavable descriotion of source 
device manufacturer 


srcDeviceModelDescTag 


Displayable description of source 
device model 


srcTechnologyTag 


Source device technology information 
such as LCD,CRT, Dye Sublimation, 
etc. 


ps2CRDTag 


PostScript Level 2 color rendering 
dictionary 


ps2CSATag 


PostScript Level 2 color space array 


ps2RenderingIntentTag 


PostScript Level 2 Rendering Intent 



'■ 



The latter three optional tags (PostScript Level 2 color rendering 
dictionary, PostScript Level 2 color space array, and PostScript Level 2 
Rendering Intent, described in detail in the PostScript Language Reference 
Manual Second Edition, provide all the necessary information to produce 

15 color-matched output on a PostScript device. Since these tags are optional, 
however, the present color management system provides facilities to derive 
equivalent information from color profiles that do not include them. The 
conversion between color profiles and PostScript is built into the color 
management system, utilizing its modular framework and code resource database 

20 manager (i.e., the Component Manager). 

The color management system, by using the code resource database 
manager, can dynamically dispatch the preferred code module to generate the 
equivalent PostScript for the given color profile. The preferred color conversion 
code module is tagged in the profile. 
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If the preferred color conversion code module is not available, the 
default code module will be invoked to convert the profile into PostScript. In 
this case, only the public profile information is used to generate PostScript. 

There are three functions defined in the color management system API 
5 for requesting conversion of profile data to PostScript. They are: 

•GetPS2ColorSpace - returns 7 bit ASCII or 8 bit binary characters 
usable as the parameter to the PostScript setColorSpace instruction. 

•GetPS2ColorRenderingIntent - returns 7 bit ASCII or 8 bit 
binary characters usable as the parameter to the PostScript 
10 setRenderinglntent instruction. 

•GetPS2ColorRendering - returns 7 bit ASCII or 8 bit binary 
characters usable as the parameter to the Postscript setColorRendering 
instruction. 

To convert a color profile into PostScript, the driver or application 

15 invokes one of the PostScript functions through the API provided by the color 

management system. The following steps describe the dispatching algorithm: 

color management dispatcher checks the preferred CMM name tagged 
with profile 

check with code module data base manager if the preferred module is 
20 available 

if the preferred module is found 

dispatch the code module with the Postscript API functions 

else 

dispatch the default code module with the Postscript API 

25 functions 

When a CMM is dispatched with the PostScript APIs, it will go through 

the following steps to pass the PostScript equivalent back to the caller: 

validate the color profile 
30 allocate data buffer for transfer 

check if there is PostScript tag included in the profile 
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if found the right tag 

convert the encoding format as requested, if necessary 

stream out the Postscript using the data buffer and the caller 
supplied call back function 

5 else 

generate the PostScript equivalent with the requested encoding 

format 

stream out the Postscript using the data buffer and the caller 
supplied call back function. 

10 

A matching session typically is set up between two device profiles, a 
source profile and a destination profile. A typical scenario is a graphic designer 
who has created a drawing on a computer monitor using a drawing application 
The designer will often want to print the design out using a color printer so the 

15 customer can see it. To ensure color fidelity, a matching session is set up with 
the source profile being the display profile for the computer monitor and the 
destination profile being the color printer profile. 

However, since different color devices have different color gamuts, some 
colors on one device may not be reproducible on another. In this case, a color 

20 close to the target will be selected. If the accuracy of the color output is 
critical, the designer may want to do a "preview" of the color output on the 
computer monitor. A matching session with three or more profiles is required 
in order to convert color from display space to printer space and then convert 
back to display space for preview purposes. The process of setting up a 

25 multiple profile matching session and reducing the transformations down to one 
is called profile concatenation. 

To set up a multiple profile matching session, there are two methods that 
the dispatcher can use. 
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Method 1: 

1. Through the color management system application program interface 
(API), an application sets up profile concatenation by providing a list of profiles 
with a "key profile" which indicates the preferred CMM to do the operation. 
5 2. If the key CMM is not available, the default CMM is dispatched to 

do the concatenation. 

3. If the key CMM is available, it will be dispatched to do the 
concatenation. If the key CMM returns an error, then the default CMM is used. 



The second method can be employed by the dispatcher or by the CMMs 
10 to perform profile concatenation. 

Method 2: 

1. Through the color management system API, the application sets up 
profile concatenation by providing a list of profiles. 

2. The dispatcher checks if the preferred CMM for each profile in the 
15 list is available. If not, it is replaced with the default CMM. 

3. A concatenated transformation table is built by sampling the source 

data space and converting the sampled color points into destination data space 

using the profiles in the list and CMMs associated with each profile. This is 

done by the following steps: 

20 a. Convert the source data to the interchange space data using the 

source CMM. 

b. Convert between interchange spaces from source profile to the 
next profile, if different, using the color space conversion 

25 functions. 

c. Convert from the interchange space to the device color space 
using the designated CMM. 

30 d. Convert from the devi .: color space to the interchange space 

using the designated C. IM. 

r 

e. Repeat steps b to d until all the profiles in the list except the last 
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one is exhausted. 

f. Convert from the interchange space to the destination data space 
using the destination CMM. 

5 

4. Colors are converted from source to destination data spaces by doing 
a table look up using the transformation table built in Step 3. 

The concatenated profile can be stored as a special type of profile (called 
a device link profile). If the user establishes a workflow pattern of designing 

10 and proofing documents, a device link profile can be saved to reflect the color 
conversion sequence by the user's workflow. 

Creating a device link profile is very similar to the profile concatenation 
process. Two algorithms can be used by the dispatcher. The only difference 
from profile concatenation is that in step 4, instead of converting colors from 

15 source data space to destination data space, a device link profile is simply 
created with th& transformation table stored in it. 

In a preferred embodiment, a device link profile is one of three special 
profiles, or transformations, in addition to the three basic device profile classes 
(input, display and output). These transformations provide a standard 

20 implementation for use by the CMM in general color processing or for the 

convenience of CMMs which may use these types to store calculated transforms. 
These three transformation classes are: device link, color space conversion, and 
abstract transformations. Device link transformations, as previously described, 
provide a mechanism in which to save and store a series of device profiles and 

25 color transformations in a concatenated format. This is extremely useful for 
workflow issues where a combination of devices and transforms are used 
repeatedly. 

Color space conversion transformations are used as a convenient method 
for CMMs to convert between different color spaces. This is particularly useful 
30 if two device profiles support different interchange spaces. Conversions 
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between base color spaces and derived color spaces are performed with known 
equations. The conversion functions are implemented in a stand-alone 
Component, making the routines available to the default CMM and to 
third-party CMMs. 

5 Finally, abstract color transformations provide a generic method for users 

to make subjective color changes to images or graphic objects. This 
transformation is encapsulated within a three dimensional table structure to 
provide maximal flexibility. These transforms, set forth in detail in Appendix 2, 
have the following signatures: 
10 'link' device link transformations, 

' spac ' color space conversion transformations, 
' abst ' abstract transformations. 

The external API implemented by the dispatcher is set forth in 
Appendix 3. 

15 It will be appreciated by those of ordinary skill in the art that the 

invention can embodied in other specific forms without departing from the 
spirit or essential character thereof. The presently disclosed embodiments are 
therefore considered in all respects to be illustrative and not restrictive. The 
scope of the invention is indicated by the appended claims rather than the 

20 foregoing description, and all changes which come within the meaning and 
range of equivalents thereof are intended to be embraced therein. 
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APPENDIX 1 

1.1 Input Profile 

This profile represents input devices such as scanners and digital cameras. 
1.1.1 Monochrome Input Profiles 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


grayTRCTag 


Gray tone reproduction curve 



The mathematical model implied by this data is: 
interchange = grayTRC[device] 
This represents a simple tone reproduction curve adequate for most monochrome 
input devices. The interchange values in this equation should represent the achro- 
matic channel of the interchange space. If the inverse of this is desired, then the 
following equation is used: 

device = grayTRC [ [interchange] 
1.1.2 RGB Input Profiles 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


redColorantTag 


Red colorant XYZ relative tristimulus values 


greenColorantTag 
blueColorantTag 


Green colorant XYZ relative tristimulus values 


Blue colorant XYZ relative tristimulus values 


redTRCTag 


Red channel tone reproduction curve 


greenTRCTag 


Green channel tone reproduction curve 


blueTRCTag 


Blue channel tone reproduction curve 
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The forward mathematical model implied by this data is 



linear R = redTRC[device r ] 
linear G = greenTRQdevice^ 
linear B = blueTRC[device b ] 

interchange x 
interchange Y 
interchange z 



redColorant x greenColorant x blueColoran^ 
redColorant Y greenColorant Y 
redColorant z greenColorant z 



blueColoranty 
blueColoranu 



linear^ 
linear G 
linear^ 



This represents a simple linearization followed by a linear mixing model. 
The three tone reproduction curves linearize the raw values with respect to the lu- 
minance (Y) dimension of the CEXYZ interchange space. The 3x3 matrix con- 
verts these linearized values into XYZ values for the CEEXYZ interchange space. 
The inverse model is given by the following equation, 



linear^ 




redColorant x 


greenColorant x 


blueColorant x 


-i 


interchangex 


linear G 




redColorant Y 


greenColoranty 


blueColoranty 




interchange Y 


linear^ 




ndColorant z 


greenColcrant z 


blueColorant z 




interchange z 



device, = redTRC x [linear R ] 
device f = greenTRC x [linear G ] 
device b = blueTRC 1 [linear B ] 

1.1.3 CMYK Input Profiles 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display j 


AToBOTag 


Device to Interchange space : 8 or 16 bit data 



The AToBOTag represents a device model described by the Lut8Type or 
Lutl6Types. This tag provides the parameter data for an algorithm that includes a 
set of non-interdependent per-channel tone reproduction curves, a three dimension- 
al lookup table and a set of non-interdependent per-channel linearization curves. 
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1.2 Display Profile 

This profile represents display devices such as monitors. 
1.2.1 Monochrome Display Profiles 



Tag Name 


General Description f 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


grayTRCTag 


Gray tone reproduction curve 



The tone reproduction curve provides the necessary information to convert between 
a single device channel and the CDEXYZ interchange space. 



The mathematical model implied by this data is: 
interchange = grayTRC[device] 
This represents a simple tone reproduction curve adequate for most monochrome 
input devices. The interchange values in this equation should represent the achro- 
matic channel of the interchange space. If the inverse of this is desired, then the 
following equation is used: 

device = grayTRC [ [interckange] 



1 .2.2 RGB Display Profiles 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


redColorantTag 


Relative XYZ values of red phosphor 


greenColorantTag 
blueColorantTag 


Relative XYZ values of green phosphor 


Relative XYZ values of blue phosphor 


redTRCTag 


Red channel tone reproduction curve 


greenTRCTag 


Green channel tone reproduction curve 


blueTRCTag 


Blue channel tone reproduction curve 



This model is based on a three non-interdependent per-channel tone repro- 
duction curves to convert between linear and non-linear rgb values and a 3x3 matrix 
to convert between linear rgb values and reladve XYZ values. The mathematical 
model implied by this data is : 
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linear R = redTRC[in r ] 
linear G = greenTRC[in s ] 
linear B = blueTRC[in b ] 

X 
Y 



redColorant x greenColorant x blueColorant x 
redColorant Y greenColorant Y blueColorant r 
redColorant z greenColorant z blueColorant z 



linear^ 
linear^ 
linear. 



This represents a simple linearization followed by a linear mixing model. 
The three tone reproduction curves linearize the raw values with respect to the lu- 
minance (Y) dimension of the CEXYZ interchange space. The 3x3 matrix con- 
verts these linearized values into XYZ values for the CEXYZ interchange space. 
The inverse model is given by the following equation, 



linear R 




linear Q 




linear B 





redColorant x greenColorant x blueColorant 
redColoraniy greenColorant Y blueColoran^ 
redColorant z greenColorant z blueColorant 

device r = r^dTRC 1 [linear R ] 
device g = greenTRCT 1 [linear c ] 
device b = blueTRC 1 [linear 3 ] 



interchange x 
interchange^ 
interchange z 



1.3 Output Profile 

This profile represents output devices such as printers and film recorders. The LUT 
tags that are required by the printer profiles contain either the 8 bit or the 16 bit 
LUTs exclusively as described in the LUT tags. The bit precision supported must 
be consistent for all of the LUT tags. The LUT algorithm for interchange space to 
device space transformations process data sequentially through a matrix, input ta- 
bles, a color LUT, and output tables. 

1.3.1 Monochrome Output Profiles 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


grayTRCTag 


Gray tone reproduction curve 



The tone reproduction curve provides the necessary information to convert between 
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a single device channel and the CIEXYZ interchange space. 

The mathematical model implied by this data is: 
interchange = grayTRC[device] 
This represents a simple tone reproduction curve adequate for most monochrome 
input devices. The interchange values in this equation should represent the achro- 
matic channel of the interchange space. If the inverse of this is desired, then the 
following equation is used: 

device = grayTRC l [interchange] 
1.3.2 RGB and CMYK Output Profiles 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions of 
theprofile name for display 


AToBOTag 


Device to Interchange space : 8 or 16 bit data: intent of 0 


BToAOTag 
gamutOTag 


Interchange to Device space : 8 or 16 bit data: intent of 0 


Out of Gamut : 8 or 16 bit data: intent of 0 


AToBlTag 


Device to interchange space : 8 or 16 bit data: intent of 1 


BToAlTag 


Interchange to Device space : 8 or 16 bit data: intent of 1 


gamutlTag 
AToB2Tag 


Out of Gamut tag : 8 or 16 bit data: intent of 1 


Device to Interchange space : 8 or 16 bit data: intent of 2 


BToA2Tag 


Interchange to Device space : 8 or 16 bit data: intent of 2 


gamut2Tag 


Out of Gamut tag : 8 or 16 bit data: intent of 2 



These tags represent a device model described by the Lut8Type or 
Lutl6Types. The intent values described in these tags directly correlate to the value 
of the rendering intent header flag of the source profile in the color modeling ses- 
sion (0 = photographic, 1 = logo color, and 2 = business graphics). In essence, each 
of these tags provides the parameter data for an algorithm that includes a 3x3 ma- 
trix, a set of non-interdependent per-channel tone reproduction curves, a three di- 
mensional lookup table and a set of non-interdependent per-channel linearization 
curves. The algorithmic details of this model and the intent of each tag is given in 
the following sub-section, specifying the general lookup table tag element structure 
for 16-bit data. 

1.4 lutl6Type 

This structure converts an 16 bit input color into an 16 bit output color. This type 
contains four processing elements: a 3 by 3 matrix (only used when the input color 
space has three components), a set of one dimensional input lookup tables, a multi- 
dimensional lookup table, and a set of one dimensional output tables. Data is pro- 
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cessed using these elements via the following sequence: 

(matrix) -> (Id input tables) -> (multidimensional lookup table) -> (Id output ta- 
bles). 



byte(s) 


content 


0-3 ; 


'mft2' (0x6D667432) type descriptor 


4-7 


reserved, must be set to 0 


Q 
o 


Num her of InDU t Channels 


Q 


Number of Ourout Channels 


10 


Number of CLUT 2nd ooints ( identical for each 
side) 


11 


Reserved for padding (required to be 0x00) 


12-15 


Encoded eOO parameter 


16-19 


Encoded eOl parameter 


20-23 


Encoded e02 parameter 


24-27 


Encoded elO parameter 


28-31 


Encoded ell parameter 


32-35 


Encoded el2 parameter 


36-39 


Encoded e20 parameter i 


40-43 


Encoded e21 parameter 


44-45 


Encoded e22 parameter 


46-47 


Number of input table entries 


48-49 


Number of output table entries 


5fcn 


input table values 


n+l-m 


CLUT values j 


ra+l-o 


output table values 



The input, output and CLUT tables are arrays of 16 bit unsigned values. 
Each input table entry is a two byte integer and each table has up to 4096 entries. 
Each input table entry is appropriately normalized to the range 0-65535. The input- 
Table is of size InputChannels * inputTableEntries * 2 bytes. 

The matrix is organized as an 3 by 3 array. The dimension corresponding 
to the matrix rows varies least rapidly arid the dimension corresponding to the ma- 
trix columns varies most rapidly and is shown in matrix form below. Each matrix 
entry is a four byte number with one sign bit, 15 integer bits, and 16 fractional bits. 
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eOO 


eOl 


eQl 


elO 


ell 


ell 


elO 


ell 


ell 



When using the matrix of an output profile, and the input data is XYZ, we 

have 



X' 




XX 


XY 


XZ 


X 


r 




YX 


YY 


YZ 


Y 


Z' 




ZX 


ZY 


ZZ 


Z 



Each input X, Y or Z is an unsigned 1.15 number and each matrix entry is a 
signed 15.16 number. Therefore, each multiplication in the matrix multiply is L15 
* sl5.16 = $16.31 and the final sum is also sl6.31. From this sum we take bits 31- 
16 as the unsigned integer result for X', Y\ or Z\ These are then used as the inputs 
to the input tables of the multidimensional LUT. This normalization is used since 
the number of fractional bits in the input data must be maintained by the matrix op- 
eration. 

The matrix is mandated to be an identity matrix for input and display pro- 
files. In addition, the matrix is mandated to be an identity matrix for output profiles 
when the interchange space is CIELAB. 

Each CLUT is organized as an n-diraensional array with a variable number 
of grid points in each dimension, where n is the number of input channels(input ta- 
bles) in the transform. The dimension corresponding to the first input channel var- 
ies least rapidly and the dimension corresponding to the last input channel varies 
most rapidly. Each grid point value contains m two byte integers, where m is the 
number of output functions. The first sequential two byte integer of the entry con- 
tains the function value for the first output function, the second sequential two byte 
integer of the entry contains the function value for the second output function, and 
so on until all the output functions have been supplied. The equation for comput- 
ing the size of the CLUT is : 



CLUTsize = LUTDimensions lmfnuChaHneb • OutputChannels • Ibytes 

The CLUT data must be padded to a 4 byte boundary with zeros at the end 
of the data if necessary. 

Each output table is a two byte integer and has up to 4096 entries. The out- 
putTable is of size OutputChannels * outputTableEntries * 2 bytes. 

When using this type, it is necessary to assign each color space component 
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to an input and output channel. The following table shows these assignments. The 
channeLs are numbered according to the order in which their table occurs. Note that 
additional color spaces can be added simply by defining the signature, channel as- 
signments, and creating the tables. 



Color Space 


Channel 1 


Channel 2 


Channel 3 


Channel 4 


XYZ' 


X 


Y 


Z 




'Lab* 


L 


a 


b 




'Luv' 


L 


u 


V 




'Yxy' 


Y 


X 


y 




'RGB* 


R 


G 


B 




'GRAY' 


K 








'HSV* 


H 


S 


V 




'HLS' 


H 


L 


S 




'CMYK' 


C 


M 


Y 


K 


'CMY' 


C 


M 


Y 





4 
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APPENDIX 2 

2. 1 Devicelink Transform 

This transform represents a one-way link or connection between devices. It does 
not represent any device model nor can it be embedded into images. 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


AToBOTag 


Actual transformation parameter structure (this is an 
exclusive or) 8 or 16 bit data 


srcDeviceAttribut- 
esTag 

srcBlackPointTag 


Device attributes for source profile 


The relative XYZ values of the black point of the 
source device 


srcDeviceModelTag 


Device model designation for source profile | 


srcManufacturerTag 


Device manufacturer for source profile 


srcWhitePointTag 


The relative XYZ values of the white point of the 
source device. 



The AToBOTag represents a device model described by the Lut8Type or 
Lutl6Types. This tag provides the parameter data for an algorithm that includes a 
3x3 matrix, a set of non-interdependent per-channel tone reproduction curves, a 
three dimensional lookup table and a set of non-interdependent per-channel linear- 
ization curves. 



2.2 ColorSpaceConversion Transform 

This transform provides the relevant information to perform a color space transfor- 
mation between the interchange color spaces. It does not represent any device mod- 
el nor can it be embedded into images. 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


BToAOTag 


Inverse transformation parameter structure (this is an 
exclusive or) 8 or 16 bit data 


AToBOTag 


Actual transformation parameter structure (this is an 
exclusive or) 8 or 16 bit data 
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srcBlackPouitTag 


The relative XYZ values of the black point of the 
source space. j 


srcWhitePointTag 


The relative XYZ values of the while point of the 
source space. 



The AToBOTag and BToAOTag represent a device model described by the 
Lut8Type or Lutl6Types. This tag provides the parameter data for an algorithm 
that includes a 3x3 matrix, a set of non-interdependent per-channel tone reproduc- 
tion curves, a three dimensional lookup table and a set of non-interdependent per- 
channel linearization curves. 



2.3 Abstract Transform 

This transform represents abstract transforms and does not represent any device 
model nor can, it be embedded into images. Color transformations using abstract 
profiles are performed within a single interchange space. 



Tag Name 


General Description 


profileDescriptionTag 


Structure containing invariant and localizable versions 
of the profile name for display 


AToBOTag 


Actual transformation parameter structure (this is an 
exclusive or) 8 or 16 bit data 



The AToBOTag represents a device model described by the Lut8Type or 
Lutl6Types. This tag provides the parameter data for an algorithm that includes a 
3x3 matrix, a set of non-interdependent per-channel tone reproduction curves, a 
three dimensional lookup table and a set of non-interdependent per-channel linear- 
ization curves. 



BNSDOCID: <WO__9531 794A1 J_> 



WO 95/31794 



J PCT7US95/06237 



- 39 - 

APPENDIX 3 

Profile File and Element Access 
OpenProfileFile 

Open specifiedCMProf lie file. Return a Prof ile reference. The profile file 
is opened with shared read/write permission. 

pascal 
CMError 

OpenProfileFile (Prof ile *prof, 

const FSSpec *fileSpec) ; 

UpdateProfileFila 

Rewrite disk file if elements of specifiecferof ile have been added or 
changed. An error will be returned if the profile file is open by another pro- 
gram. 

pascal 
CMError 

UpdateProf ilerile (Prof ile prof) 
CtoseProfiie 

Close data file and free memory allocations associated with specifiedro- 
f ile. Changes to the file are not automatically recorded. SeajpdatePro- 
fileFileU). 

pascal 
CMError 

CloseProf ile (Prof ile prof) 
NewProfiie 

Create new empty Prof ile and associated backing file. TheProf ile must 
be populated and updated by the client program. The default disk file type 
is 'prof. The default profile contents include thecM2Header and an empty 
element table. All fields of the^M2Header will be set to zeroes excepts ize 
and prof ileVers ion. 

pascal 
CMError 

NewProf ile (Profile *prof, const FSSpec *baclcingFileSpec) 
CopyProfile 

Duplicate aProf ile. Temporary changes which have been made to the 
source Profile are included in targetCMProf ile disk file. 

pascal 
CMError 
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CopyProf ile (Prof ile 'profCopy, 

cons: FSSpec *copyFileSpec, 
Profile prof); 

VaiidateProfilo 

Test whether Profile contains the minimum set of elements. This function 
is dispatched to the CMM specified by ths>rof Ue CMMTypeTag element. 

pascal 
CMError 

ValidateProf ile (Prof ile prof* Boolean *valid) ; 
FlattenProfile 

Flatten specifiedProf ile to the external CMProf ile format A caller sup- 
plied FlattenProcU?? is called to perform the actual data transfer. The 
flags parameter specifies options for the content of the QattenedMProf ile. 

This function is used to create an erabeddectMProf ile which can be used 
for graphic documents. The element subset is normally specified by the 
sourceProf Elements flag. The qd32KLimi t flag should be used for Quick- 
draw PicCommentS. 

This routine is dispatched to the CMM Component specified by tharo- 
f ile CMMTypeTag element. If the CMM is not available then the default Ap- 
ple CMM is called. The default elements are flattened and the function 

result is CMMethodNotround. 

enum { 

AtoBElemencs= 1, 
BtoA£lements= 2, 
intentO = 4, 
intentl =8, 
intent2 = 10, 
qd32KLimiC * 20 

>; 

AtoBElementsInclude elements necessary for the source side of a matching 

session. Common case for a graphic docu- 
ment profile tag. 

BtoAElementsInclude elements necessary for the destination side of a 



matching session. 
intentO Include elements necessary for rendering intent 0. 

intent 1 Include elements necessary for rendering intent L 

intent2 Include elements necessary for rendering intent 2. 



qd32KLirait FlattenedcMProf ile may not exceed 32K, the limit for 

QuickDraw PicComraents. 
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pascal 
CMError 

FlattenProfile (Profile prof, long flags, FlaetenProcUP* 
proc, 

void *refCon) ; 

Parameters 

prof (in) Source Profile 

flags (in) Specifies op tions for destinationcMPr o file, 
proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls. t<proc. 

Result codes 
noErr 

paramErr Result specified by flags is not possible. 

Le. sourceProfileElements I 
destProfileElements I 
resolveReferences I 
qd32KLimit 

cmms thodNo trour.cCMM Corresponding toprof iie not available 
System or ColorSync result code if an error occurs 
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UnflattanProflle 

Uaflacten an external forraaCMProf ile to an independent disk file. 
A client-suppliedFiac=sn?rocUPP is called to perform the actual data 
transfer. 

This function may be used to create aProf ile reference from acMProf ile 
embedded in a graphic document The caller is responsible for calling Open- 
ProfileFile(. . .) and then clean-up by callingrioseProf ile u) and FspDe- 
lete u> when use of the profile is completed. 

This routine is dispatched to the CMM Component specified by th^ro- 
file CMMTypeTag element. If the CMM is not available then the default Ap- 
ple CMM is called. The function result in this case will be 
CMMethodNot Found. 

pascal 
CMError 

Unf latrenProzila(?5Scec •resultFileSpec, FlattenProc.UPP 
proc, 

void ^refCon) ; 

Parameters 

resultRleSpec (out)Retums profile file spec if function result iaioErr or 

QiMethodNot Found. Otherwise undefined. 

proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls Kproc, 

Result codes 
noErr 

CMMethodNotFoundCMM corresponding to Prof ile not available 
System or ColorSync result code if an error occurs 
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FlattenProf ile(_) and "Jr.f latcenProfile U) use a caller-supplied 
f latcenProc function ro perform the actual data transfer. Thiseiatten- 
Proc function is also a parameter to the PostScript-related utility functions. 
This mechanism allows the caller to control the low level transfer. 

Communication with thef lactanProc function uses a command parameter. 

enum { 

OpenReadSpooL = 1, 
OpenWriteSpool , 
ReadSpool, 
WriteSpool, 
CloseSpool 

}; 

OpenReadSpool Begin the process of readng data. 
OpenWriteSpoolBegin the process of writing data. 
ReadSpool Read size bytes. 
WriteSpool Write size bytes. 
CloseSpool Finish data transfer. 

typede f pascal OSZrr ( *F lattenProcPtr) (unsigned char com- 
mand, 

unsigned long 

*size, 

void *data, void 

*refCon) ; 

#if USHSROUTINEDESCaIPTORS 

typed© f Universal?r-c?trFlattenProcUPP; 

#else- 

typedef FlattanProcPrrFlattenProcUPP ; 
#endif 

Parameters 

COmmand(in) Specifies operation. 

Size (in/out)Scecif ies data size on input. 

Returns actual size transferred. 

data (in) Address of buffer. 

refCon (in) Client data which is passed as a parameter to calls to the 

f lattenProc. 
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ProfileEIomentExists 

Test whether an element with specified tag signature is present ujrof ile. 

pascal 
CMError 

Prof ileElementlxis::s (Profile prof, OSType tag. 

Boolean * found) ; 

CountProfileEIements 

Return one-based count of elements contained iiProf ile. Tags which are 
references are counted as elements. 

pascal 
CMError 

CountProfileElener.wS (Profile prof, long *elementCount) 
GetProfileEIement 

Get element data for specified tag. The caller is responsible for allocating 
storage. 



pascal 
CMError 

GetProfileEIement (Profile prof, OSType tag, 

long *alementSize, void *elementData) ; 

GetProffteHeader 

Get copy of header for the specifiedProf ile. 



pascal 
CMError 

GetProfileHeader (Profile prof, AppleProf ileHeader ♦head- 
er); 

GetPartJalProfileElement 

Get part of element data for specified tag. The caller is responsible for allo- 
cating storage. 



pascal 
CMError 

GetPartialProf ileElement (Profile prof, OSType tag, 

unsigned long offset, 
unsigned long byteCount, 
void *elementData) ; 
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SetProfileEIementSize 

Reserve size of element data for specified tag. This function must be used 
before callingSetPartialProfileElementU). 

pascal 
CMError 

SetProf ileElementSize (Profile prof, OSType tag, 

unsigned long elementSize) ; 

SetPartialProfilaEIament 

Set pan of element data for specified tag. 

pascal 
CMError 

SetPartialProfiiaEiement (Prof ile prof, OSType tag, 

unsigned long offset, 
unsigned long byteCount, 
void *elementData) ; 

GetlndaProfilaEIamentlnfo 

Obtain element tag and data size by index in the range of L.elementCount 
(as retufaed byCpuntPrsfileSlements (_)). 



pascal 
CMError 

GetlndProf ileElaina-t Info (Profile prof, unsigned long in- 
dex, 

OSType *tag, unsigned long * ele- 
mentSize, 

Boolean *refs) ; 

GatlndProflleEIement 

Get data for element at specified index. Caller is responsible for allocating 
storage. 

pascal 
CMError 

GetlndProfileElement (Profile prof, unsigned long index, 

unsigned long *elementSize, void ♦el- 
ement Data) ; 

SetProfileElament 

Set element data for specified tag. If an element with the specified tag is al- 
ready present in the Profile, the existing element data is replaced. 

pascal 
CMError 

SetProf ileElement (Prof ile prof, OSType tag, 
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unsigned long elementSize, void •ele- 

mentData) ; 
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SetProfileHeader 

Set header for the specifiedProf ile. 



pascal 
CMError 

SetProfileHeader (Prof ile prof, const AppleProf ileHeader 
♦header) ; 

SetProflleElomentReferenca 

Add tag to Profile which references data corresponding to a previously set 
element. 

After successful completion of this function there will be more than one tag 
corresponding to a single piece of data. All of these tags are "equal citizens". 
If setProf ileElemenc (-) is subsequently called for one of the common 
tags then the new element data will be "appended" to therof ile rather 
than replacing the existing data. 

It is possible to set a reference to an element which was originally a refer- 
ence itself without circularity. 

pascal 
CMError 

SetProf ileElemer.HRaferance (Profile prof, OSType element- 
Tag, 

OSType referenceTag) 

RemoveProfileElement 

Remove element with specified tag signature fronprof ile. 

pascal 
CMError 

RemoveProfileElement (Profile prof, OSType tag); 

Low-level Matching 

To use the low level routines you first create a color matching world, or 
CWorld, which establishes how matching will take place between the given 
source and destination profiles. Calling NewColorWorld gives you a color 
matching world and DisposeColorWorld gets rid of it. 

You can match individual colors by passing the color and the color match- 
ing world to the matching utilities. This allows you to set up your matching 
parameters one time, do all the matching you want using the color matching 
world, and then clean up. Furthermore, it allows you to send and receive col- 
ors directly in XYZ, CMYK, or Gray color spaces rather than just RGB. 
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You can also match an individual pixel map, or determine whether or not a 
list of colors is in the gamut of a particular color space. 

NCWNewCoiorWorid 

Set up a matching session forsrc and dst Profiles. The CMM Compo- 
nents) involved will fetch theProf ile elements necessary for the matching 
session. 

The src and dst Pro files may be closed withcioseProf ile U) after 
calling this function. 

pascal 
CMError 

NCWNe wC o 1 o r Wo r 1 d ( CWa rid *myCWorld, Profile src. Profile 
dst) ; 

NCWConcatCoiorWorid 

Set up a session for color processing which includes a set oferof iles. The 
CMM Component specified by theProfile atConcatProf ileSet .keyln- 
dex will fetch the?rof ile elements necessary for the session. 

The specified Prof iles may be closed withcioseProfileU) after calling 
this function. 



pascal 
CMError 

NCWConcatColorWorid (CWorld 'myCWorld, 

ConcatProf ileSet *prof ileSet) ; 

Parameters 

myCWorld(in/out)Retunis reference to session if function result isnoErr. 

Otherwise undefined. 

profileSet(in) ConcatProf ileSet contains an array of Prof iles which 

describe the processing to be carried out 

The prof ileSet array is in processing or- 
der — Source through Destination. A mini- 
mum of one Profile is required. 

TheCMMType element of Pro file atkeyln- 
dex specifies the CMM which is entirely re- 
sponsible for the session. 

struct ConcatProf ileSet 
{ 

unsigned shor tkey Index; / * zero- 
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based •/ 

unsigned shortcount ; 
Profile profileSet [1] ; 

}; 

Result codes 
noErr 

System or ColorSync result code if an error occurs. 

CWNewLinkProfile 

This function allows the creation of a newProf ile which embodies the 
transforms included byNa*concaecoiorWorid(_) . 

pascal 
CMError 

CWNewLinkProfile (Profile »prof, 

consz FSSpec *backingFileSpec, 
ConcacProf ileSec *prof ileSet) 

Parameters 

myCWorld(in/out)Returns reference to session if function result isnoErr. 

Otherwise undefined. 

backingFileSpec (in)File spec for the resultingCMProfiie. 

profileSet(in) concatProf ileSec contains an array of Prof iles which 

describe the processing to be carried out. 

The profileSet array is in processing or- 
der— Source through Destination. A mini- 
mum of one Profile is required. 

The CMMType element Of Prof ile at key In- 
dex specifies the CMM which is entirely re- 
sponsible for the session. 

Result codes 
noErr 

System or ColorSync result code if an error occurs. 



CWDisposeCoforWorld 

Free private storage associated with acworld. 

pascal 
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void 

CWDisposeCoIorWorld (CWorld rayCWorld) ; 
CWMatehColors 

Match colors according to the?ro files corresponding to acworld. On en- 
try, the CMColor values are taken to be therfataType of the Source Profile. 
On exit, thecMCoior values are transformed to the dataType of the Desti- 
nation Prof ile. 

Matching sessions set up with one of the Multichannel color data types are 
supported with this function. 

pascal 
CMError 

CWMatehColors (CWcrld myCWorld, CMColorList myColors, 
long count) ; 

CWCheckColors 

Gamut test colors according to theprof iles corresponding to mycworld. 
On entry, thecMCoior values are taken to be thedataType of the Source 
Profile. The gamut test is a preflight of color-matching with this:worid. 
The result bit array indicates whether the colors in the list are in or out of 
gamut fbr the DestinationProfile. 

Matching sessions set up with one of the Multichannel color data types are 
supported with this function. 

pascal 
CMError 

CWCheckColors (eWorld myCWorld, CMColorList myColors, 

unsigned long count, CMGamutResult result) ; 
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CWMatchBItMap 

Match pixel data ofcitMa? according to thePro files corresponding to my- 
CWorld. 

typedef pascal Boolean ( *BitMapCallBackProcPtr) (long 
progress, 

void *ref- 

Con) ; 

#if USESROUTINEDESCRr?TORS 

typedef Universal ProcPtr BitMapCallBackUPP; 
#else 

typedef BitMapCall3ackProcPtr BitMapCallBackUPP; 
#endif 

pascal 
CMError 

CWMatchBitMap (CTorld myCWorld, const CMBitMap *bi tMap , 
BitMapCallBackUPP progressProc, 
void *re£Con, CMBitMap # matchedBitMap) ; 

CWCheckBltMap 

:■■ 

Gamut test pixel data ofeitMa? according to theProf iles corresponding 
to myCWorld. 



pascal 
CMError 

CWCheckBi tMap ( eWorld nyCWorld, CMBitMap *bitMap, 
BitMapCallBackUPP progressProc, 
void *rafCon, 
CMBitMap *resultBitMap) ; 

Quickdraw-specific Matching 
CWMatchPixMap 

Match pixel data ofctyPixMap according to the Prof iles corresponding to 
myCWorld. myPixMap must be non-relocatable. 

pascal 
CMError 

CWMatchPixMap (CWor Id myCWorld, PixMap *myPixMap, 

BitMapCallBackUPP progress Proc , void # ref- 

Con) ; 
CWCheckPixMap 

Gamut-test pixel data ofmyPixMap according to theProf iles correspond- 
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ing to raycworidL myPixMap must be aon- relocatable. 

pascal 
CMError 

CWCheckPixMap(CWcrld myCWorld, PixMap *ntyPixMap, 

BitMapCallBackUPP progressProc, void ^refCon, 
BitMap *resultBitMap) ; 

NBeginMatching 

Set up a high-level matching session forsrc and dst Profiles. 

If the currentGDevice is a monitor device then subsequent Quickdraw op- 
erations to all monitorGDevicas will matched. Otherwise automatic match- 
ing will be limited to the currenGDevice. 



pascal 
CMError 

NBeginMatching (Profile src , Profile dst, CMMatchRef 
*myRef ) 

EndMatching 

Restore unmatched Quickdraw operations and free private allocations for 
the 

high-level matching session. 

pascal 
void 

EndMatching (CMMatchRef myRef ) 
NDrawMatchedPicture 

Bracket orawPicturaU) with WhiteFang function calls which set up and 
take down a high-level matching session. The Picture will be drawn with 
matched colors to all monitoiGDevices. If the current GDevice is not a 
monitor Device then matching will occur for thaBDevice only. This func- 
tion and DrawPictura (_) operate in the context of the cunenCGraf Port. 
Color-matchingPicCocments embedded in the Picture are respected. 

pascal 

void 

NDrawMatchedPicture (PicHandle myPicture, Profile dst, 
Rect *myRect) 

EnableMatching 

Generate aCMEnableMatching or CMDisabieMatching PicComment for 
currendy open Picture. 



pascal 
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void 

EnableMatching (Boolean enablelt) 
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External Profile Searching 

Search and access functions for?rof lies in the ColorSync™ Profiles folder. On 
the Macintosh this is located in {SystemFoIder} Preferences: Search specifications 
are defined by : 

/* Defines for version 2.0 Prof ileSearchRecord.searchMask */ 

#define kMatchProf ileCMMTypeOxOOOOOOOl 

#define IcMatchProf iieClass 0x00 0000 02 

#define kMatchDeviceSpaceOxO000OO04 

#def ine kMatchIntarchangeSpace0x00O00GQ8 

#define kMatchManuf acturerOxOOOOOOlO 

#define JcMatchModel 0x00000020 

#define kMatchAttributesOx00000040 

#define kMatchProf ileFlagsGxOO 000080 

typede f 
pascal 

Boolean ( w Prof ileFilter?roc?tr ) (Profile prof, void *refCon) ; 

#if USESROUTINEDESCHIPTCRS 

typedef UniversalProcPtr Prof ileFilterUPP; 

#else 

typedef Prof ilerilterProcPtr Prof ileFilterUPP; 
#endif 

strict ProfileSearchRecord { 
OSType * CMMType; 
OSType prof ileClass ; 

OSType deviceCoiorSpace; 
OSType intarchar.geColorSpace; 
unsigned longdeviceManufacturer ; 
uns igned longdeviceMode 1 ; 
unsigned longdeviceAt tributes (2 ] ; 
unsigned longprof iler lags ; 

unsigned longs earchMask; 
ProfileFiltarUPPfilter; 

typedef struct ProfileSearchRecordProf ileSearchRecord; 

The bits of searchMask specify corresponding fields which must match in the 
search. 

filter is a client function which can be used to search on elements outside the de- 
fined ProfileSearchRecord fields to implement OR or AND search logic. This 
function returns true if the specified profile is to be filtered from the search. 

The data structure which contains the result of a profile search is a private abstract 
type. 

typedef structPrivateProf ileSearchResult*Prof ileSearch; 
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The search functions are implemented in a private standalone Component. It is reg- 
istered at startup with the following parameters. 



c omp o n e n t Typ e 


•prof 


componentSubType 


'df If 


c ompo nen tManu f ac tur er 


•appl' 



This Component is opened and called by the resident dispatcher to implement the 
WhiteFang APL 
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NewProfifeSoarch 

Description. 

pascal 
CMError 

NewPr o f i 1 eSear =h (Prof i leSearchRecord * searchSpec , 

void *refCon, unsigned long 'count, 
Prof ileSearch *searchResule) ; 

UpdateProfileSearch 

Update an existing search result This is necessary if the contents of the 
ColorSync™ Profiles folder has changed since the search result was creat- 
ed. 

Sharing a disk over a network makes it possible for the folder contents to be 
modified at any time. 

pascal 
CMError 

UpdateProf ileSearch (Prof ileSearch search, void *refCon, 

unsigned long *count) 

DisposeProfileSearch 

Free private allocations associated with asearch result. 

pascal 
void 

DisposeProf ileSearch (Prof ileSearch search) ; 
SearchGetlndexedProfile 

Open and return reference to theprofile at index into search result The 
caller is responsible for closing the returnedProf ile. 

pascal 
CMError 

SearchGetlndexedProf ile (Prof ileSearch search, unsigned 
long index, 

Profile *prof ) ; 

SearchGetindexedProfileFileSpec 

Get file specification for theProf ile at index into search result 

Cross-platform implementations will define th$>rof ileFile parameter as 
appropriate to the OS. 

pascal 
CMError 
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SearchGetlndexedProf ileFileSpec ( Prof ileSearch search, 

unsigned long index, 
FSSpec »profileFile) ; 

System Profile Access 

The System Profile represents an abstract device. It is used as the default color 
space if a Profile is not specified for the WhiteFang matching functions. The Sys- 
tem Profile is that of an RGB or GRAY monitor for Color QuickDraw. 

GatSystemProflle 

Return Profile reference for current System Profile. Caller is responsible for 
callingCloseProfile(-) when finished. 

pascal 
CMError 

GetSystemProf ile (Profile *prof ) ; 

SatSystemProfile 

Set specified profile file as the current System Profile. 

pascal 
CMError 

SetProfile (const FSSpec *prof ileFileSpec) ; 

Utilities 

GetColorSyncFoldorSpec 

Return the HFS volume refNum and directory ID of the ColorSync™ Pro- 
files folder. Optionally create folder if it does not already exist 

pascal 
CMError 

Ge tc o lor SyncFolder Spec (short vRefNum, Boolean createFold- 
«r, 

short *foundVRefNum, long *f oundDi- 

rlD) ; 
GdtCWInfo 

Supply information about an existing CWorkL The information is returned 
in the caller's CWInfoRecord structure whose address is passed as theinf o 
parameter. 

struct CMMInfoRecord { 
OSType CMMType; 
long CMMVersion; 

}; 
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typedef s cruet: OfrTTnf oRecordCMMInf oRecord; 

struct CWInfoRecord { 

unsigned shortcanCount; 
CMMInfoRecordcxnlnf o [2] ; 

>; 

typedef struct CWInf oRecordCWInfoRecord; 



pascal 
CMError 

GetCWInfo (CWorld myCWorld, CWInfoRecord *info) ; 

PostScript support functions 

Three functions are added to the WhiteFang API and as optional functions in the 
CMM Component API to support color-matching by PostScript Level 2 devices. 

The flags parameter to these three function specifies the format of the PostScript 
data to be returned. 

enum { 

ps7bit si, 
ps8bit = 2 

}; 

ps7bit specifies 7-bit ASCII 

psabit specifies 8-bit per character data as specified in th&ostScript Language 
Reference Manual second edition. 

GetPS2ColorSpaco 

Return ASCII text usable as the parameter to the PostScrip*etcoiorspace 
operator. 

This operator characterizes the color space of subsequent graphics data. 

This function is dispatched to the CMM Component corresponding to 
srcProf . If the Component is not available or the function is not imple- 
mented then it is dispatched to the default CMMtextData is set by the de- 
fault CMM and the function result imiMethodNotFound. 

A caller-supplied Plane nProc function is used to perform the actual data 
transfer. 

pascal 
CMError 

GetPS2ColorSpace (Prof ile srcProf, unsigned long flags, 
FlattehUPP proc, void *refCon) ; 
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Parameters 

srcProf (in) Reference to source Pro file. 

flags (in) specifies desired format of PostScript data 

proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls tq>roc. 

Result codes 
noErr 

CMMethodNotFoundCMM corresponding tosrcProf not available. 
System or ColorSync result code if an error occurs. 



G*tPS2ColorRenderinglntant 

Return ASCII text usable as the parameter to the PostScripsetRendering- 
intent operator. This operator specifies the color-matching option for sub- 
sequent graphics data. 

This function is dispatched to the CMM Component corresponding to 
srcProf. If the Component is not available or the function is not imple- 
mented then it is dispatched to the default CMMtextData is set by the de- 
fault CMM and the function result isaiMethodNotFound. 

A caller-supplied FlattenProc function is used to perform the actual data 
transfer. 

pascal 
CMError 

GetPS2CoIofRenderingIncant( Profile srcProf, unsigned long 
flags, 

FlattenOTP proc, void *refCon) ; 

Parameters 

srcProf (in) Reference to sourceprof ile. 

flags (in) specifies desired format of PostScript data 

proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls tqproc. 
Result codes 

no Err 

CMMethodNotFoundCMM corresponding toprof not available. 
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System or CoIorSync result code if an error occurs. 



GetPS2ColorRondoring 

Return ASCII text usable as the parameter to the PostScripfcetcoiorRen- 
dering operator. This operator specifies the PostScript Color Rendering 
dictionary to be used for the following graphics data. 

This function is dispatched to the CMM Component corresponding to 
srcProf. If the Component is not available or the function is not imple- 
mented then it is dispatched to the default CMMtextData is set by the de- 
fault CMM and the function result is^WechodNotFound. 

A caller-supplied FlattenProc function is used to perform the actual data 
transfer. 

pascal 
CMError 

GetPS2ColorRendering (Profile srcProf, Profile dstProf, 

unsigned long flags, FlattenProc 

proc, 

void *refCon) ; 

Parameters 

srcProf (in) Reference to source Profile. 

dstProf (in) Reference to destinationProf ile. 

flags (in) specifies desired format of PostScript data 

proc (in) Function for data transfer 

refCon(in) Client data which is passed as a parameter to calls t<*>roc. 

Result codes 
noErr 

CMMethodNotFoundCMM corresponding toprof not available. 
System or CoIorSync result code if an error occurs. 
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CMM Component Function Reference 

A CMM is a Component Manager Component The standard required Component 
functions must be supported 

IcCoraponentOpenSelect 

kComponentCloseSeiect 

kComponentCanDoSeiect 

kComponentVersionSelect 

The standard optional Component functions may also be supported 
kComponentRegisterSelect 
kComponentTargetSelect 

The dispatcher determines the CMM Components which will be responsible from 
the CMMType element of the?rcfiie parameters to the client call One or two 
CMMs perform the actual work. 

A separate Componendnstance is opened for each matching session.The set o£ro- 
f iles is unique for each session. The Component should allocate private storage to 
store the necessary information for the instance and use Component Manager func- 
tions to manage the storage. A Component should free the storage in the Compo- 
nentClose function. 

The CMM Component functions are in either required or optional categories. For 
optional functions, the dispatcher will call the Component with the kComponent- 
CanDoSeiect selector before calling the actual function. 

If the CMM does not support an optional function, the dispatcher will use an alter- 
native to complete the client request- For example, if the CMM does not support the 
CMMatehBitMap function, the dispatcher will convert the BitMap data tmco lor 
format and call the CMNfadMatchColors function. The matched colors will then 
be copied to die client BitMap. 

Required Functions 



NCMlnit 

Component function called to initialize a matching session. Called after the 
Component has been opened with OpenComponent(...). 

pascal 
CMError 

NCMlnit (Component Instance CMSession, Profile srcProfile, 
Profile dstProfile); 

CMMatchColors 
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Color-matching on a lis: of CMColor. The source and destination data types 
are specified by theprof ile parameters to the previous call to the NC- 
MInit(...\ CMInit(...), orCMConcatInit(...) function. 

pascal 
CMError 

CMMatchColors (Componentlnstance CMSession, 

CMColorList myColors, long count) ; 

CMCheckCotors 

Gamut test a list of CMColor. The source and destination are specified by 
the Profile parameters to the previous call to the NCMInit(...), 
CMInit(...)» or CMConcatInit(...) function. 

pascal 
CMError 

CMCbeckColors (Componentlnstance CMSession, 

CMColorList myColors, long count, 
OGamutResult result) ; 

CMValidateProflle 

Test whether Pro file contains the minimum set of elements required by 
thisCMM. 

Third-party CMMs should first call the default CMM using Component 
Manager functions to assure that the minimum default elements are present. 

pascal 
CMError 

CMValidateProf ile (Componentlnstance CMSession, Profile 
prof, 

Boolean *valid) ; 



CMFlattenProflle 

Flatten specifiedProfile to the externalcMProf ile format A caller-sup- 
plied FlattenProcUPP is called to perform the actual data transfer. The 
flags parameter specifies options for the content of the flattenedMPro- 
file. 

The default Apple implementation of this function must be capable of flat- 
tening any Prof ile which contains the minimum required elements. 

pascal 
CMError 

CMFlattenProf ile (Componentlnstance CMSession, Profile 
prof, 

long flags, FlattenUPP proc, void *ref- 

Con) ; 
CMUnflattenProfile 
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Unflatten an external forraacMProf iie to an internal formacprof iie ref- 
erence. 

This function may be used to create aProf iie reference from acMProfiie 
embedded in a graphic document. The caller is responsible for calling 
cioseProf iie U) when the use of the Profile reference is completed. 

The returned Pro file has a temporary backing file if necessary. The file is 
deleted at the timeciose?rof iie (_) is called. 

pascal 
CMError 

CMUnf lattenProf iie {Component Instance CMSession, Profile 
•prof, 

FlattenOTP proc, void *refCon) 

Parameters 

CMSeSSion(in)Reference to Component Xns tance. 

prof (out) Returns ?ro f iie reference if function result isnoErr. 

Otherwise undefined. 

proc (in) Funcdon for data transfer 

refCon (in) Client data which is passed as a parameter to calls tQ>roc 

Result codes 
noErr 

System or ColorSync result code if an error occurs 
Optional Functions 



CMMatchBftMap 

Match pixel data of bitMap according to thfrrof iie parameters supplied 
ID a previous call tOCMInit U) t NCMInitU) , orCMConcatlnitU). 

pascal 
CMError 

CMMatchBitMap {Component Ins tance CMSession, const CMBitMap 
♦bitMap, BitMapCallBackUPP progressProc, void *refCon, 

CMBitMap *matchedBitMap) ; 

CMCheckBitMap 

Gamut test pixel data of bitMap according to tha>rof iie parameters sup- 
plied to a previous call tOCMInitU), NCMInit U) , Or CMConcatlnit(-). 
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pascal 
CMError 

04Check3itMap (Coraponentlnstance CMSession, const: CMBitMap 
♦bitMap, 

BitMapCallBackUPP progressProc, void *refCon, 
CMBitMap *result3itMap) ; 

CMMatchPlxMap 

Match pixel data ofinyPixMap according to the Pro file parameters sup- 
plied to a previous Call tOCMIaitU), NCMInitU) , Or CMConcatlnit (-.). 

myPixMap is non-relocatable. 

pascal 
CMError 

CMMatchPlxMap (Component Instance CMSession, PixMap *myPix- 
Map, 

BizMapCallBackOPP progressProc, long refCon) ; 

CMChockPixMap 

Gamut-test pixel data o£ny?ixMap according to theprof ile parameters 
supplied to a previous call tocMinit U) , NCMinit u> , or CMConca- 
tlnit u) . myPixMa? is non-relocatable.. 

palcai 
CMError 

CMCheckPixMap(CociponentInstance CMSession, PixMap *myPix- 
Map , 

BitMapCallBackUPP progressProc, BitMap *my- 

BitMap, 

long re f Con) ; 

CMConcatlnit 

This is a special purpose function that is outside the domain of the standard 
source -» destination matching session. A single CMM is specified by the 
caller which is responsible for the entire session. That CMM may use Com- 
ponent Manager functions to call other CMMs if required. 

The processing possible with this function can be complex, including oper- 
ations outside of simple "matching**. 

Note that thedataType and deviceType of the first and lastProf iles must 
be valid device values. IntermediateProf iles may be non-device type val- 
ues. 

pascal 
CMError 

CMConcatlnit ( Component Ins tance CMSess ion , 

ConcatProf ileSet *profileSet) ,- 

Parameters 
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CMSession(in)Reference to Coraponentlnstance. 

profileSet(in) concat?rof ileSet contains an array of Prof iles which 

describe the processing to be carried out 

The prof ileSet array is in processing or- 
der — Source through Destination. A mini- 
mum of one Profile must be specified 

The CMMType element of Prof ile at Iceyln- 
dex specifies this CMM, which is entirely re- 
sponsible for the session. 

struct ConcatProfileSet 
{ 

unsigned shortkey Index; 
unsigned shortcount; 
Profile prof ileSet [1] ; 

}; 

Result codes 
noErr 

System or ColorSync result code if an error occurs. 
CMNewLinkProfllo 

This function allows the creation of a newprof ile which embodies the 
transforms included byiicwconcatcoiorworldu). 

Note that thedataType and deviceType of the first and lastProf iles must 
be valid device values. Intennediateprof iles may be non-device type val- 
ues. 

pascal 
CMError 

CMNewLinkProfile(CcmponentInstance CMSession, Profile 
♦prof, 

const FSSpec *backingFileSpec, 
ConcatProfileSet *prof ileSet) ; 

Parameters 

CMSession(in)Reference to Componentlnstance. 

backingFileSpec (in)File spec for the resultingCMProf ile. 

profileSet(in) ConcatProfileSet contains an array of Pro files which 

describe the processing to be carried out 

TheprofileSet array is in processing or- 
der — Source through Destination. A mini- 
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Result codes 
no Err 



mum of one Profile is required 

TheCMMType element of Profile atkeyln- 
dex specifies the GMM which is entirely re- 
sponsible for the session. 



System or ColorSync result code if an error occurs. 
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CMG«tPS2ColorSpac* 

Return ASCII text usable as the parameter to the PostScripfceccoiorspace 
operator. 

TTiis operator characterizes the color space of subsequent graphics data. 

A caller-supplied FlattenProc function is used to perform the actual data 
transfer. 

pascal 
CMError 

CMGetPS2Co lor Space (Component Instance CMSession, Profile 
srcProf, unsigned long flags, FlattenUPP proc, 

void *refCon) ; 

Parameters 

CMSession(in)Reference to Coraponentlnstance. 
srcProf (in) Reference to source Pro file, 
flags (in) specifies desired format of PostScript data 
proc (in) Function for data transfer 

rcfCon (in) Client data which is passed as a parameter to calls CQaroc. 

Result codes 
noErr 

System or ColorSync result code if an error occurs. 

CMGetPS2ColorR«ndaringlntont 

Return ASCII text usable as the parameter to the PostScripsetRendering- 
Intent operator. This operator specifies the color-matching option for sub- 
sequent graphics data. 

A caller-supplied FlattenProc function is used to perform the actual data 
transfer. 

pascal 
CMError 

CMGetPS2ColorRenderingIntent (Component Instance CMSession, 

Profile srcProf, 
unsigned long flags, 
FlattenUPP proc, void *ref- 

Con) ; 

Parameters 
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CMSession(in)Reference to Corapooentlnstance. 
srcProf (in) Reference co source Pro file, 
flags (in) specifies desired format of PostScript data 
proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls t(j>roc. 

Result codes 
noErr 

System or CoiorSync result code if an error occurs. 

CMG*tPS2Coforfl*ndering 

Return ASCII text usabie as the parameter to the PostScripeetcolorRen- 
derihg operator. This operator specifies the PostScript Color Rendering 
dictionary to be used for subsequent graphics data. 

A caller-supplied FlanenProc function is used to perform the actual data 
transfer. 

pascal 
CMError 

CMGecPS2ColorRenceri:ig(ComponentInscance CMSession, Pro- 
file srcProf, 

Profile dstProf, unsigned long 

flags, 

FlattenUPP proc, void *refCon) ; 

Parameters 

CMSession(in)Reference to Componentlnstance. 

srcProf (in) Reference to sourceProf ile. 

dstProf (in) Reference to destinationpr o f i le. 

flags (in) specifies desired format of PostScript data 

proc (in) Function for data transfer 

refCon (in) Client data which is passed as a parameter to calls t<s>roc. 

Result codes 
noErr 

System or CoiorSync result code if an error occurs 



WO 95/31794 




PCT7US95/06237 



- 69 - 

What Is Claimed Is: 

1. In a color management system providing a modular framework 
having a default color matching module and in which color matching modules 
may be added to and removed from the system, a method of selecting and using 

5 one or more color matching modules to perform a requested color matching 
operation of source data specified in a source data space described by a source 
profile and destination data specified in a destination data space described by a 
destination profile, the source profile identifying a designated 
source-profile-preferred color matching module and the destination profile 

10 identifying a designated destination-profile-preferred color matching module, the 
method comprising the steps of: 

a) if the source profile preferred color matching module is unavailable, 
designating instead a default color matching module as the designated 
source-profile-preferred color matching module for purposes of selection, 

15 and if the destination profile preferred color matching module is 

unavailable, designating instead a default color matching module as the 
designated destination-profile-preferred color matching module for 
purposes of selection, 

b) if following step a) the designated source-profile-preferred color 
20 matching module and the designated destination-profile-preferred color 

matching module are the same color matching module, using said same 
color matching module to build a concatenated transformation table by 
sampling color points in a source color space specified in the source 
profile and converting the sampled color points into a destination color 
25 space specified in the destination profile, and converting colors from the 

source color space to the destination color space by table lookup using 
the concatenated transformation table; else 

c) if following step a) the designated source-profile-preferred color 
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matching module and the designated destination-profile-preferred color 
matching module are different, using the designated 
source-profile-preferred color matching module and the designated 
destination-profile-preferred color matching module to build a 
5 concatenated transformation table by sampling color points in a source 

color space specified in the source profile and converting the sampled 
color points into a destination color space specified in the destination 
profile, and converting colors from the source color space to the 
destination color space by table lookup using the concatenated 
10 transformation table, 

2. The method of Claim 1, wherein the designated 
source-profile-preferred color matching module and the designated 
destination-profile-preferred color matching module use a common color 
interchange space, step c) further comprising: 
15 converting the source data to data in the common color 

interchange space using the designated source-profile-preferred color matching 
module; and 

converting the data in the common color interchange space to 
destination data using the designated destination-profile-preferred color matching 
20 module. 



3. The method of Claim 1, wherein the designated 
source-profile-preferred color matching module and the designated 
destination-profile-preferred color matching module use different color 
interchange spaces, step c) further comprising: 
25 converting the source data to data in the source color interchange 

space using the designated source-profile-preferred color matching module; 

converting the data in the source color interchange space to a 
destination color interchange space using a color space conversion function; and 
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converting the data in the data color interchange space to 
destination data using the designated destination-profile-preferred color matching 
module. 

5 4. In a color management system providing a modular framework 

having a default color matching module and in which color matching modules 
may be added to and removed from the system, a method of validating color 
profiles describing color characteristics of color images or devices, comprising 
the steps of: 

10 accessing the profile to identify a preferred color matching 

module; 

if the preferred color matching module is available, dispatching 
the preferred color matching module to perform validation of the profile; and 
if the preferred color matching module is not available, 
15 dispatching a default color matching module to perform validation of the profile. 

5. In a color management system providing a modular framework 
having a default color matching module and in which color matching modules 
may be added to and removed from the system, a method of converting data in 

20 a color profile designating a preferred color matching module to color profile 
PostScript data, comprising the steps of: 

if the preferred color matching module is available, dispatching the 
preferred color matching module to convert the non-PostScript data to PostScript 
data; and 

25 if the preferred color matching module is not available, dispatching a 

default color matching module to convert the non-PostScript data to PostScript 
data. 

6. In a color management system providing a modular framework 
having a default color matching module and in which color matching modules 

30 may be added to and removed from the system, a method of creating a 
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concatenation of color profiles describing color characteristics of color devices, 
comprising the steps of: 

designating one of the color profiles as a key profile, the key profile 
containing data identifying a preferred color matching module; 
5 if the preferred color matching module is available, dispatching the 

preferred color matching module to perform the concatenation of the color 
profiles; and 

if the preferred color matching module is not available, dispatching a 
default color matching module to perform the concatenation of the color 
10 profiles. 

7. In a color management system providing a modular framework 
having a default color matching module and in which color matching modules 
may be added to and removed from the system, a method of creating a 
concatenation of a sequence of color profiles, including a first source profile and 
15 a last destination profile, describing color characteristics of color devices, each 
of the color profiles identifying a designated profile-preferred color matching 
module, the method comprising the steps of; 

if a designated profile-preferred color matching module is unavailable, 
designating instead a default color matching module as the designated 
20 profile-preferred color matching module; and 

building a concatenated transformation table by sampling color points in 
a source color space specified in a first profile and converting the sampled color 
points into a final color space specified in a final profile using the designated 
profile-preferred color matching modules by: 
25 for a first color profile, converting color profile information from 

a source profile color space to a color interchange space using a 
corresponding designated profile-preferred color matching module; 

for each successive color profile before a last color profile, 
converting from a color interchange space of a preceding color matching 
30 module to a color interchange space of a present color matching module 
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if the color interchange space of the preceding color matching module 
and the color interchange space of the present color matching module are 
different, converting from the color interchange space of the present 
color matching module to a color profile space of the present color 
5 matching module using a corresponding designated profile-preferred 

color matching module, and converting from the color profile space of 
the present color matching module to a color interchange space of the 
present color matching module using said corresponding designated 
profile-preferred color matching module; and 
10 for a last color profile, converting from a color 

interchange space of a preceding color matching module to a 
color interchange space of the last color matching module if the 
color interchange space of the preceding color matching module 
and the color interchange space of the last color matching module 
15 are different; and 

converting from the color interchange space of the last color 
matching module to a color profile space of the last color matching 
module using a corresponding designated profile-preferred color 
matching module and converting colors from the first color space to the 
20 last color space by table lookup using the concatenated transformation 

table. 

8. In a color management system providing a modular framework 
having a default color matching module and in which color matching modules 
may be added to and removed from the system, a method of creating a device 
link profile describing an overall color characteristic of multiple color devices, 
comprising the steps of: 

if a designated profile-preferred color matching module is unavailable, 
designating instead a default color matching module as the designated 
profile-preferred color matching module; and 

building a concatenated transformation table by sampling color points in 
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a source color space specified in a first profile and converting the sampled color 
points into a final color space specified in a final profile using the designated 
profile-preferred color matching modules by: 

for a first color profile, converting color profile information from a 

5 source profile color space to a color interchange space using a corresponding 
designated profile-preferred color matching module; 

for each successive color profile before a last color profile, converting 
from a color interchange space of a preceding color matching module to a color 
interchange space of a present color matching module if the color interchange 

10 space of the preceding color matching module and the color interchange space 
of the present color matching module are different, converting from the color 
interchange space of the present color matching module to a color profile space 
of the present color matching module using a corresponding designated 
profile-preferred color matching module, and converting from the color profile 

15 space of the present color matching module to a color interchange space of the 
present color notching module using said corresponding designated 
profile-preferred color matching module; and 

for a last color profile, converting from a color interchange space of a 
preceding color matching module to a color interchange space of the last color 

20 matching module if the color interchange space of the preceding color matching 
module and the color interchange space of the last color matching module are 
different, and converting from the color interchange space of the last color ' 
matching module to a color profile space of the last color matching module 
using a corresponding designated profile-preferred color matching module; and 

25 creating a new color profile including the concatenated transformation 

table. 
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